ποΈGitΠ―ΡΠ°ποΈ
docs/et-rEE/user/mqtt.md ce1a9fca2b7beae317db6f59d76ebb652ca332f6 (ce1a9fca) Text, 7.15 KB
title: MQTT
parent: User Guide
nav_order: 11
last_updated: 2026-05-13
description: Silda oma vΓ΅rk internetiga β MQTT maakleri seadistamine, krΓΌpteerimiskihid ja kaardiaruandlus.
aliases:
β’ mqtt
β’ internet-bridge
β’ broker
MQTT
MQTT ΓΌhendab Meshtastic vΓ΅rgu internetiga, vΓ΅imaldades raadiolevi ulatusest kaugemale ulatuvat pikamaasidet.
Overview
MQTT moodul ΓΌhendab sinu sΓ΅lme MQTT vahendajaga, vΓ΅imaldades:
β’ Messages to reach nodes on different physical meshes via the internet
β’ Integration with home automation and monitoring systems
β’ SΓ΅lmede asukoha avaldamine avalikul Meshtastic kaardil
β’ Custom data pipelines for logging and alerting
How It Works
T282828
[Sinu sΓ΅lm] β Raadio β [WiFi-ga lΓΌΓΌsisΓ΅lm] β MQTT vahendaja β [KauglΓΌΓΌs] β Raadio β [KaugsΓ΅lm]
InternetiΓΌhendusega (WiFi vΓ΅i Ethernet) lΓΌΓΌsisΓ΅lm jagab vΓ΅rgusΓ΅numeid MQTT. Remote gateways subscribed to the same topic inject those messages into their local mesh.
SΓ€tted
Luba MQTT
1. Mine menΓΌΓΌsse Seaded β Mooduli konfiguratsioon β MQTT.
2. Luba MQTT moodul.
3. Configure the broker connection:
ββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββ
β SΓ€tted β Kirjeldus β Vaikimisi β
ββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββΌββββββββββββββββββββββ€
β Server Address β MQTT vahendaja hostinimi β mqtt.meshtastic.org β
β Kasutajatunnus β Broker authentication β meshdev β
β Parool β Broker authentication β large4cats β
β Root Topic β Base topic for messages β msh β
β Encryption β KrΓΌpteeri MQTT liiklus β Lubatud β
β ~~JSON vΓ€ljund~~ β β οΈ Vananenud β JSON pakettide tugi on pΓΌsivarast eemalβ¦ β Keelatud β
β TLS β Secure connection to broker β Keelatud β
β Map Reporting β Report position to public map β Keelatud β
ββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββ
Meshtastic vaikemaakler
Kogukond haldab avaliku vahendajat aadressil T383838mqtt.meshtastic.org. This is intended for general use and testing.
β π Privaatsus: Avaliku vahendaja sΓ΅numeid saavad lugeda kΓ΅ik tellijad. Always use channel
β encryption for private communications.
Private Broker
Parema privaatsuse ja kontrolli tagamiseks saad hallata oma MQTT maaklerit:
β’ Mosquitto (lightweight, open-source)
β’ HiveMQ
β’ EMQX
Configure your node to point to your private broker with appropriate credentials.
Map Reporting
Kui kaardiaruandlus on lubatud, avaldab sΓ΅lm oma asukoha Meshtasticu kogukonnakaardil:
β’ Visible at meshmap.net and similar community map services
β’ Only position and node info are shared
β’ Disable this if you don't want your location publicly visible
Γleslink vs allalink
βββββββββββββ¬βββββββββββββββββββββββββββββββββββββ
β Direction β Kirjeldus β
βββββββββββββΌβββββββββββββββββββββββββββββββββββββ€
β Γleslink β SΓ΅numid kΓ€rgvΓ΅rgust β MQTT maakler β
β Allalink β SΓ΅numid MQTT maaklerist β kΓ€rgvΓ΅rk β
βββββββββββββ΄βββββββββββββββββββββββββββββββββββββ
Configure per-channel which directions are active to control message flow and airtime usage.
Message Formats
MQTT kasutab protobuf-sΓ΅numivormingut:
ββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββ
β Format β Kirjeldus β Use case β
ββββββββββββΌβββββββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββ€
β Protobuf β Binaarne Meshtastic protobuf kodeering β Node-to-node mesh bridging β
ββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββ
β β οΈ MΓ€rkus: JSON vΓ€ljundi tugi eemaldati pΓΌsivarast. The T383838json_enabled setting is still visible in
β the app for legacy compatibility but has no effect on current firmware versions.
Encryption & Privacy
Understanding the layered encryption model:
1. Kanali krΓΌptimine toimub kΓ€rgvΓ΅rgus enne MQTT. Kui kanalil on PSK, on ββMQTT liiklus juba krΓΌptitud β maakler ja kΓ΅ik tellijad nΓ€evad ainult Ε‘ifriteksti.
2. MQTT krΓΌptimine (mooduli sΓ€te) lisab vahendajale edastamiseks tΓ€iendava krΓΌptimiskihi. This protects metadata and routing information.
3. TLS krΓΌpteerib TCP ΓΌhenduse vahendaja endaga, takistades vΓ΅rgutasandil pealtkuulamist.
β π TΓ€htis: Vaikimisi avalikul kanalil on tuntud vΓ΅ti. MQTT kaudu saadetud vaikekanalil olevad
β sΓ΅numid on sisuliselt krΓΌpteerimata β igaΓΌks saab neid dekodeerida. Always use a custom PSK for
β private communications.
Best Practices
β’ Kasuta kanali krΓΌptimist (PSK), kanalitel mis on sillatud MQTT-ga
β’ Γra luba MQTT internetiΓΌhenduseta sΓ΅lmedel (see puhverdab ja raiskab mΓ€lu)
β’ Use a private broker for sensitive deployments
β’ MQTT sΓ΅numite allalaadimisel arvesta eetriaja kuluga β iga allalingitud sΓ΅num tarbib sinu kohalikus vΓ΅rgus raadioeetriaega
β’ Kaalu ainult ΓΌleslingi lubamist, kui sul on vaja oma kΓ€rgvΓ΅rku eemalt jΓ€lgida ilma sΓ΅numeid tagasi tΓ΅mbamata
Troubleshooting
MQTT ei ΓΌhendu
β’ Kontrolli WiFit β lΓΌΓΌssΓ΅lmel peab olema aktiivne internetiΓΌhendus (WiFi vΓ΅i Ethernet). MQTT ei tΓΆΓΆta LoRa raadiolingi enda kaudu.
β’ Verify credentials β incorrect username or password will silently fail on most brokers. Double-check for trailing spaces.
β’ TulemΓΌΓΌr β port 1883 (MQTT) vΓ΅i 8883 (MQTT+TLS) peab olema avatud. Some networks block non-standard ports.
β’ DNS resolution β if using a custom broker hostname, verify the node can resolve it. Try the broker's IP address directly.
Messages Not Bridging
β’ Kontrolli ΓΌleslingi/allalingi seadeid β kui lubatud on ainult ΓΌleslink, liiguvad sΓ΅numid vΓ΅rgust MQTT-sse, aga mitte tagasi. Luba vastuvΓ΅tval lΓΌΓΌsil allalink.
β’ Channel mismatch β both gateways must share the same channel with the same PSK. A mismatch means messages are encrypted with different keys and appear as garbage.
β’ Topic mismatch β ensure both gateways use the same root topic. The default T383838msh works for the public broker.
Related Topics
β’ Seaded β Moodulid ja administreerimine β MQTT mooduli konfi viide
β’ SΓ΅numid ja kanalid β kanali krΓΌptimine ja PSK seadistamine
β’ MQTT integratsioonijuhend β ΓΌksikasjalik MQTT dokumentatsioon aadressil meshtastic.org
Served by rngit 1.5.2 - Generated in 0.09s